home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / glmaterial.z / glmaterial
Encoding:
Text File  |  2002-10-03  |  13.4 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ggggllllMMMMaaaatttteeeerrrriiiiaaaallll((((3333GGGG))))                 OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                 ggggllllMMMMaaaatttteeeerrrriiiiaaaallll((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllMMMMaaaatttteeeerrrriiiiaaaallllffff,,,, ggggllllMMMMaaaatttteeeerrrriiiiaaaalllliiii,,,, ggggllllMMMMaaaatttteeeerrrriiiiaaaallllffffvvvv,,,, ggggllllMMMMaaaatttteeeerrrriiiiaaaalllliiiivvvv - specify material
  10.      parameters for the lighting model
  11.  
  12.  
  13. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  14.      void ggggllllMMMMaaaatttteeeerrrriiiiaaaallllffff( GLenum _f_a_c_e,
  15.                        GLenum _p_n_a_m_e,
  16.                        GLfloat _p_a_r_a_m )
  17.      void ggggllllMMMMaaaatttteeeerrrriiiiaaaalllliiii( GLenum _f_a_c_e,
  18.                        GLenum _p_n_a_m_e,
  19.                        GLint _p_a_r_a_m )
  20.  
  21.  
  22. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  23.      _f_a_c_e    Specifies which face or faces are being updated.  Must be one of
  24.              GGGGLLLL____FFFFRRRROOOONNNNTTTT, GGGGLLLL____BBBBAAAACCCCKKKK, or GGGGLLLL____FFFFRRRROOOONNNNTTTT____AAAANNNNDDDD____BBBBAAAACCCCKKKK.
  25.  
  26.      _p_n_a_m_e   Specifies the single-valued material parameter of the face or
  27.              faces that is being updated.  Must be GGGGLLLL____SSSSHHHHIIIINNNNIIIINNNNEEEESSSSSSSS.
  28.  
  29.      _p_a_r_a_m   Specifies the value that parameter GGGGLLLL____SSSSHHHHIIIINNNNIIIINNNNEEEESSSSSSSS will be set to.
  30.  
  31. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  32.      void ggggllllMMMMaaaatttteeeerrrriiiiaaaallllffffvvvv( GLenum _f_a_c_e,
  33.                         GLenum _p_n_a_m_e,
  34.                         const GLfloat *_p_a_r_a_m_s )
  35.      void ggggllllMMMMaaaatttteeeerrrriiiiaaaalllliiiivvvv( GLenum _f_a_c_e,
  36.                         GLenum _p_n_a_m_e,
  37.                         const GLint *_p_a_r_a_m_s )
  38.  
  39.  
  40. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  41.      _f_a_c_e Specifies which face or faces are being updated.  Must be one of
  42.           GGGGLLLL____FFFFRRRROOOONNNNTTTT, GGGGLLLL____BBBBAAAACCCCKKKK, or GGGGLLLL____FFFFRRRROOOONNNNTTTT____AAAANNNNDDDD____BBBBAAAACCCCKKKK.
  43.  
  44.      _p_n_a_m_e
  45.           Specifies the material parameter of the face or faces that is being
  46.           updated.  Must be one of GGGGLLLL____AAAAMMMMBBBBIIIIEEEENNNNTTTT, GGGGLLLL____DDDDIIIIFFFFFFFFUUUUSSSSEEEE, GGGGLLLL____SSSSPPPPEEEECCCCUUUULLLLAAAARRRR,
  47.           GGGGLLLL____EEEEMMMMIIIISSSSSSSSIIIIOOOONNNN, GGGGLLLL____SSSSHHHHIIIINNNNIIIINNNNEEEESSSSSSSS, GGGGLLLL____AAAAMMMMBBBBIIIIEEEENNNNTTTT____AAAANNNNDDDD____DDDDIIIIFFFFFFFFUUUUSSSSEEEE,  or
  48.           GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXXEEEESSSS.
  49.  
  50.      _p_a_r_a_m_s
  51.           Specifies a pointer to the value or values that _p_n_a_m_e will be set
  52.           to.
  53.  
  54. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  55.      ggggllllMMMMaaaatttteeeerrrriiiiaaaallll assigns values to material parameters.  There are two matched
  56.      sets of material parameters.  One, the _f_r_o_n_t-_f_a_c_i_n_g set, is used to shade
  57.      points, lines, bitmaps, and all polygons (when two-sided lighting is
  58.      disabled), or just front-facing polygons (when two-sided lighting is
  59.      enabled).  The other set, _b_a_c_k-_f_a_c_i_n_g, is used to shade back-facing
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllMMMMaaaatttteeeerrrriiiiaaaallll((((3333GGGG))))                 OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                 ggggllllMMMMaaaatttteeeerrrriiiiaaaallll((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      polygons only when two-sided lighting is enabled.  Refer to the
  75.      ggggllllLLLLiiiigggghhhhttttMMMMooooddddeeeellll reference page for details concerning one- and two-sided
  76.      lighting calculations.
  77.  
  78.      ggggllllMMMMaaaatttteeeerrrriiiiaaaallll takes three arguments.  The first, _f_a_c_e, specifies whether the
  79.      GGGGLLLL____FFFFRRRROOOONNNNTTTT materials, the GGGGLLLL____BBBBAAAACCCCKKKK materials, or both GGGGLLLL____FFFFRRRROOOONNNNTTTT____AAAANNNNDDDD____BBBBAAAACCCCKKKK
  80.      materials will be modified.  The second, _p_n_a_m_e, specifies which of
  81.      several parameters in one or both sets will be modified.  The third,
  82.      _p_a_r_a_m_s, specifies what value or values will be assigned to the specified
  83.      parameter.
  84.  
  85.      Material parameters are used in the lighting equation that is optionally
  86.      applied to each vertex.  The equation is discussed in the ggggllllLLLLiiiigggghhhhttttMMMMooooddddeeeellll
  87.      reference page.  The parameters that can be specified using ggggllllMMMMaaaatttteeeerrrriiiiaaaallll,
  88.      and their interpretations by the lighting equation, are as follows:
  89.  
  90.      GGGGLLLL____AAAAMMMMBBBBIIIIEEEENNNNTTTT          _p_a_r_a_m_s contains four integer or floating-point values
  91.                          that specify the ambient RGBA reflectance of the
  92.                          material.  Integer values are mapped linearly such
  93.                          that the most positive representable value maps to
  94.                          1.0, and the most negative representable value maps
  95.                          to -1.0.  Floating-point values are mapped directly.
  96.                          Neither integer nor floating-point values are
  97.                          clamped.  The initial ambient reflectance for both
  98.                          front- and back-facing materials is (0.2, 0.2, 0.2,
  99.                          1.0).
  100.  
  101.      GGGGLLLL____DDDDIIIIFFFFFFFFUUUUSSSSEEEE          _p_a_r_a_m_s contains four integer or floating-point values
  102.                          that specify the diffuse RGBA reflectance of the
  103.                          material.  Integer values are mapped linearly such
  104.                          that the most positive representable value maps to
  105.                          1.0, and the most negative representable value maps
  106.                          to -1.0.  Floating-point values are mapped directly.
  107.                          Neither integer nor floating-point values are
  108.                          clamped.  The initial diffuse reflectance for both
  109.                          front- and back-facing materials is (0.8, 0.8, 0.8,
  110.                          1.0).
  111.  
  112.      GGGGLLLL____SSSSPPPPEEEECCCCUUUULLLLAAAARRRR         _p_a_r_a_m_s contains four integer or floating-point values
  113.                          that specify the specular RGBA reflectance of the
  114.                          material.  Integer values are mapped linearly such
  115.                          that the most positive representable value maps to
  116.                          1.0, and the most negative representable value maps
  117.                          to -1.0.  Floating-point values are mapped directly.
  118.                          Neither integer nor floating-point values are
  119.                          clamped.  The initial specular reflectance for both
  120.                          front- and back-facing materials is (0, 0, 0, 1).
  121.  
  122.      GGGGLLLL____EEEEMMMMIIIISSSSSSSSIIIIOOOONNNN         _p_a_r_a_m_s contains four integer or floating-point values
  123.                          that specify the RGBA emitted light intensity of the
  124.                          material.  Integer values are mapped linearly such
  125.                          that the most positive representable value maps to
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ggggllllMMMMaaaatttteeeerrrriiiiaaaallll((((3333GGGG))))                 OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                 ggggllllMMMMaaaatttteeeerrrriiiiaaaallll((((3333GGGG))))
  137.  
  138.  
  139.  
  140.                          1.0, and the most negative representable value maps
  141.                          to -1.0.  Floating-point values are mapped directly.
  142.                          Neither integer nor floating-point values are
  143.                          clamped.  The initial emission intensity for both
  144.                          front- and back-facing materials is (0, 0, 0, 1).
  145.  
  146.      GGGGLLLL____SSSSHHHHIIIINNNNIIIINNNNEEEESSSSSSSS        _p_a_r_a_m_s is a single integer or floating-point value
  147.                          that specifies the RGBA specular exponent of the
  148.                          material.  Integer and floating-point values are
  149.                          mapped directly.  Only values in the range [0,128]
  150.                          are accepted.  The initial specular exponent for both
  151.                          front- and back-facing materials is 0.
  152.  
  153.      GGGGLLLL____AAAAMMMMBBBBIIIIEEEENNNNTTTT____AAAANNNNDDDD____DDDDIIIIFFFFFFFFUUUUSSSSEEEE
  154.                          Equivalent to calling ggggllllMMMMaaaatttteeeerrrriiiiaaaallll twice with the same
  155.                          parameter values, once with GGGGLLLL____AAAAMMMMBBBBIIIIEEEENNNNTTTT and once with
  156.                          GGGGLLLL____DDDDIIIIFFFFFFFFUUUUSSSSEEEE.
  157.  
  158.      GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXXEEEESSSS    _p_a_r_a_m_s contains three integer or floating-point
  159.                          values specifying the color indices for ambient,
  160.                          diffuse, and specular lighting.  These three values,
  161.                          and GGGGLLLL____SSSSHHHHIIIINNNNIIIINNNNEEEESSSSSSSS, are the only material values used
  162.                          by the color index mode lighting equation.  Refer to
  163.                          the ggggllllLLLLiiiigggghhhhttttMMMMooooddddeeeellll reference page for a discussion of
  164.                          color index lighting.
  165.  
  166. NNNNOOOOTTTTEEEESSSS
  167.      The material parameters can be updated at any time.  In particular,
  168.      ggggllllMMMMaaaatttteeeerrrriiiiaaaallll can be called between a call to ggggllllBBBBeeeeggggiiiinnnn and the corresponding
  169.      call to ggggllllEEEEnnnndddd.  If only a single material parameter is to be changed per
  170.      vertex, however, ggggllllCCCCoooolllloooorrrrMMMMaaaatttteeeerrrriiiiaaaallll is preferred over ggggllllMMMMaaaatttteeeerrrriiiiaaaallll (see
  171.      ggggllllCCCCoooolllloooorrrrMMMMaaaatttteeeerrrriiiiaaaallll).
  172.  
  173.      While the ambient, diffuse, specular and emission material parameters all
  174.      have alpha components, only the diffuse alpha component is used in the
  175.      lighting computation.
  176.  
  177. EEEERRRRRRRROOOORRRRSSSS
  178.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if either _f_a_c_e or _p_n_a_m_e is not an accepted
  179.      value.
  180.  
  181.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if a specular exponent outside the range
  182.      [0,128] is specified.
  183.  
  184. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  185.      ggggllllGGGGeeeettttMMMMaaaatttteeeerrrriiiiaaaallll
  186.  
  187.  
  188. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  189.      ggggllllCCCCoooolllloooorrrrMMMMaaaatttteeeerrrriiiiaaaallll, ggggllllLLLLiiiigggghhhhtttt, ggggllllLLLLiiiigggghhhhttttMMMMooooddddeeeellll
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.